Wozu ist der Bot?
Der Bot soll die POCs eines FS bei der Ausrichtung eines FS (aktuelle VirtualFS) unterstützen und den Agents das hochladen der Statistiken vereinfachen und ihnen eine Kontrolle geben.
Der Bot ist darauf ausgelegt, so wenig wie möglich Daten der Agents zu speichern.
Es gibt 4 Rechte Level für den Bot:
Webserver-Admin - richtet den Bot auf dem Webserver ein und hat damit den höchsten Einflussgrad - für Ihn gibt es eine extra Anleitung
Bot-Admin - Hat die höchsten Rechte innerhalb des Bots, wird vom Webserver-Admin fest in den Einstellungsdateien des Bots konfiguriert.
Er kann:
MOD - Ist für die eigentlichen FS zuständig
Er kann
Jeder Bot-Admin hat automatisch MOD-Rechte, auch wenn er lt. Einstellung kein MOD ist. Das hat aber Einfluss auf die Angezeigte Hilfe...
Agents - SInd die normalen Teilnehmer eines FS
Können
Der Bot arbeitet Befehlsorientiert, alles was er machen soll, muss ihm über Befehle mitgeteilt werden. Befehle fangen mit einem “/” an direkt gefolgt von dem Befehl. Einige Befehle können zusätzlich auch Parameter entgegennehmen.
Eine Befehlsübersicht liefert das Kommando /help.
Um die Bedienung zu erleichtern wechselt er bei einigen Befehlen in einen Menügeführten Modus mit “Tasten”. Auch während diesem Modus können jederzeit Befehle in die Eingabezeile des Bots eingegeben werden, ohne dass das Menü verschwindet.
Wenn der Bot Eingaben erwartet, ist der Befehlsmodus zurückgestellt. Alles was eingegeben wird, auch Befehle werden vom Bot als Eingaben interpretiert und entsprechend bewertet.
Nur der Befehl /cancel kann diesen Eingabemodus unterbrechen.
Dauert die Eingabe zu lange, wird der Bot sie abbrechen. Er wartet dann wieder auf Befehle.
Werden eingegebene Befehle ignoriert, kann man mit dem Befehl /cancel eine etwaige Eingabe beenden.
Als Ausnahme reagiert der Bot auf empfangene Ingress-Stats und bestimmte Dokumente.
Mit dem Befehl /setuserstatus können jedem angemeldeten Agent MOD rechte erteilt oder entzogen werden.
/setuserstatus jan
Rufe den Befehl mit einem Teil des Namens des Agents auf. Der Bot wird dann alle passenden Agents mit dem Zeitpunkt der letzten Anmeldung zur Auswahl anbieten.
Nach der Auswahl des Agents wird der aktuelle Status angezeigt und eine Option zum Upgraden oder Degradieren.
Rufe /nextfs alleine oder /nextfs 2020-10-01 mit einem Datum auf.
Der Bot wird den nächsten 1. Samstag des Monats ermitteln und eine Übersicht aller auf diesem Server für diesen Tag eingestellten FS mit den auf Fevgames angemeldeten Agenten liefern.
Zur Konfiguration des FS wird das Kommando /config benutzt.
Darin finden sich bei MODs die Punkte “Fevgames”, “FS-Daten” und “Fevgames Google-Sheet”.
Ein Weg wäre als erstes Fevgames zu konfigurieren:
Dazu wird in der ersten Zeile des Fevgames-Menüs die Fevgames-Id festgelegt. Die Taste drücken, die Fegames-Id in der Eingabezeile eingeben und absenden.
Jetzt können mit “Import von Fevgames” die Fevgames Daten in den “Userdatensatz” zur weiteren Anpassung importiert werden.
Fevgames-Abfragen können zu Verzögerungen führen.
Danach sieht man im Menükopf die importierten Daten. Diese sind bisher nur im “Userdatensatz” zwischengespeichert.
Mit den beiden Tasten hinter “Upl.-Fenster” kann die Startzeit und Endzeit des Zeitfensters für den Empfang der Statistiken etwas angepasst werden. Einfach mehrfach die Tasten drücken, bis das Zeitfenster im Menü-Kopf passt.
Jetzt können die Daten mit “Daten in die FS-Konfig übernehmen” in die Bot-Konfiguration geschrieben werden. Sind die Daten in der FS-Konfig und dem Userdatensatz gleich, erscheint ein grüner Hacken hinter dem Button-Text.
Genau so können die Zeiten mit den nächsten Buttons auch in die Selfi- und Scoringsheet-Config übernommen werden.
Mit “Zurück” kommen wir wieder in das /config-Menü.
In diesem Menü sehen wir im Kopf schon die von Fevgames übernommenen Daten.
Mit den ersten 4 Menüzeilen könnten wir diese noch mal anpassen.
Danach kann eine Fehlermeldung stehen: “⚠ Fevgames-Sheet nicht bis FS-Ende änderbar ⚠”. Diese wird später im /config-Menüpunkt “Fevgames-Google-Sheet behandelt. Sie dient hier nur zur Information.
Als nächstes haben wir drei Zeilen “Meet”, “Photo”, “Restock”. Im Moment interessiert nur die erste Zeile.
Klicken wir auf den Marker, erwartet der Bot eine Position für den Treffpunkt “Meet”. Diese können wir dem Bot als Intel-, Google- oder Apple-Link übergeben. Aussderm können wir auch einfach eine Position via Telegram an den Bot schicken.
Das Etikett ist die Beschreibung des Treffpunktes (z.B.: der Portalname).
Dahinter folgt die Uhrzeit.
Die Zeile “Format Ausgabe für /fs” legt die Ausgabe des Befehles /fs fest. Nach Auswahl des Punktes kommen erstmal 3 Infos vom Bot.
Der Text kann einfaches HTML enthalten (https://core.telegram.org/api/entities).
Die Platzhalter sind
Die nächsten Zeilen in diesem FS-Menü enthalten die Wertungen für den FS:
Voreinstellung ist Level, Lifetime AP und XM Recharged. Klickt man auf eine der Zeilen, kommt ein neues Menü mit allen möglichen Werten - der aktuelle Wert ist mit einem grünen Hacken markiert - und einem “Papierkorb” in der letzten Zeile.
Klickt man auf einen Wert, wird dieser übernommen, der “Papierkorb” löscht diesen Wert und lässt evtl. nachfolgende Werte aufrücken.
Nun können wir zurück zum /config-Menü
In diesem Menü kannst Du für die gesetzten Wertungen Mindestvorgaben machen.
Ist eine Vorgabe festgelegt, steht der Wert hinter der Wertung.
Klicke die jeweilige Wertung um den Wert anzupassen.
Setze den Wert auf 0 um die Vorgabe zu deaktivieren.
Soll die Wertung auch das zweite Verify im Fevgames-Google-Sheet beeinflussen, so achte darauf, dass das Ausgabeskript Version 4 im folgenden Abschnitt gewählt wird.
Als Sheet musst Du das Manual-Scoring-Sheet verwenden:
https://docs.google.com/spreadsheets/d/1kDU2GWwni_ZMXdswVHDkaMAfWdAfM08WoZFFF_ZCbCw/copy
https://fevgames.net/ingressfs/auto-score-sheet/
ganz am Ende:
https://docs.google.com/spreadsheets/d/10do1X0StD_MVZbLPGgwjq1dpXHDkbbR19IxFeQ5QrVU/copy
Erstelle eine Kopie in Deinem Google-Drive.
Der Letzte Button dieses Menüs führt Dich auch direkt zum Manual-Sheet-Template.
Im Kopf des Fevgames-Sheets-Menüs siehst Du in der letzten Zeile die E-Mail-Adresse des “Freigabeusers”.
Gib diesem in Deinem neuen Manual-Sheet bitte schreibrechte.
Aktiviere gleich noch die Linkfreigabe zum “Lesen” des Sheets, damit Fevgames die Daten nachher auslesen kann.
Klicke die erste Zeile des Menüs “Link des Sheets” und übergib dem Bot den Link aus der Kopfzeile Deines Browsers oder über Freigabe Link kopieren.
Nach dem Senden sollte der Bot Dir im Menükopf den Namen Deines Sheets anzeigen, oder eine Fehlermeldung.
Wenn der Bot Daten von Drive holt, kann es zu kurzen Verzögerungen kommen.
Damit der Bot das Sheet nicht nach dem FS schreibt, musst Du in der 3. Zeile eine Endzeit für den Zugriff auf das Sheet festlegen.
Ist diese Zeit vor dem FS-Ende, erscheint die Fehlermeldung “⚠ Fevgames-Sheet nicht bis FS-Ende änderbar ⚠”, die wir schon FS-Menü erwähnt hatten. Dies ist eine Warnung! Wird diese nicht beachtet, werden keine oder nicht alle Daten bis zum Schluß in das Sheet geschrieben. Die Daten des FS speichert der Bot in den Datensätzen der jeweiligen Agents. Sie gehen also nicht verloren, wenn die Agents oder ein MOD sie dort nicht löscht. Wie diese Daten auch später in das Sheet geschrieben werden können, werde ich beim Befehl /flushsheet beschreiben.
Die Option (Zeile) “Fevgames-User ins Sheet aufnehmen” kann durch klicken an- und abgeschalten werden.
Ist diese aktiv, kann man während des FS sehen, wer angemeldet ist und noch keine Statistik gesendet hat, wer seinen Namen falsch geschrieben hat…
Der Bot bietet mehrere Skripte, um die Daten in das Sheet zu schreiben. bitte wähle in der letzten Zeile “Auswahl der Sheetversion” die Version “2 - Sheet Version 2.6 Manual (Zeilen ermitteln)”. Sie wird dann im Kopf als
Version: 2
Sheet Version 2.6 Manual (Zeilen ermitteln)
erscheinen.
Oder die Version “4 - Sheet Version 2.6 Manual (Bedingtes Verify)”, wenn Du das zweite Verify an Bedingungen knüpfen willst.
Damit sollte die Grundlegende FS-Konfiguration abgeschlossen sein.
Die Nutzung des GoogleForms zum senden von Daten an den Bot ist nur eine Ausnahmelösung für Agents, die kein Telegram haben. Die Agenten bekommen keine Rückmeldungen vom Bot. Es gibt keine Möglichkeit zu kontrollieren wer die Daten sendet, die Zuordnung erfolgt ausschließlich anhand des Ingame-Namens.
Sollte der Ingame Name während des FS auch Daten via Bot senden, werden die Daten aus dem Form komplett ignoriert!
Teile den Link zum Formular nur mit diesen Agents.
Einrichtung:
Erstelle ein Formular mit zwei “Absatz”-Formularfeldern.
Gehe in die Einstellungen des Formulars und aktiviere “Maximal eine Antwort” und “Nach dem Senden bearbeiten”.
Verbinde das Form mit einem GoogleSheet, oder lass das Form ein GoogleSheet erstellen.
Die Adresse dieses Sheets trägst Du unter /config - “GoogleForm-Config” - “Link des Sheets” ein.
Der Bot liest das Formular bei jedem cron aufruf (siehe Wartung) in den FS-Datensatz.
Dies lässt sich auch mit dem Button “FormularSheet einlesen” auslösen.
Die Buttons “Erfasste Formular Daten anzeigen” und “Erfasste Formular Daten löschen” beziehen sich auf diesen internen Formularspeicher, das vom Formular gespeiste Sheet wird vom Bot ausschließlich gelesen.
Der Bot vergleicht die Daten aus dem Sheet jedesmal mit den internen Daten und gleicht selbige so ab, dass die günstigsten Werte intern gespeichert werden. Somit können Nutzer die Daten im Form auch bearbeiten und neu Absenden.
Erstelle eine Telegram-Gruppe für die MODs, die sich um die Selfis und die Collageerstellung kümmern. Ernenne die MODs zu Admins der Gruppe, nur Admins können in der Gruppe Bilder verifizieren.
Füge der Gruppe den Bot hinzu. Er benötigt keine Rechte zum lesen von Nachrichten.
Gib in der Gruppe den Befehl /connect ein. Damit wird der Bot in dieser Gruppe aktiv.
Der Bot ist immer nur in einer Gruppe aktiv.
Unter /config - “Selfi-Verwaltung” kannst Du analog eine Gruppe verbinden, sofern der Bot sie kennt.
Mit “Chat trennen und verlassen” trennst Du den Bot von der Aktuellen Gruppe. Der Bot verlässt die Gruppe und “vergisst” sie.
Stelle mit “Uploads Start” und “Uploads Ende” den Zeitraum ein, in dem Agents ihre Selfis an den Bot senden können.
Während des Zeitfensters können Agenten Ihre Bilder an den Bot senden. Der Bot leitet die Bilder in die Verbundene Gruppe weiter und bietet dort ein Menü zur Bestätigung an.
Mit dem Button “Setze auf FS-Upload-Zeiten” übernimmt den FS-Upload-Zeitraum für den Selfi-Upload.
✅ Ist Bedingung, oder ❌ ist Bedingung legt fest, ob das Selfi als Bedingung für das zweite Verify gelten soll. Achte, wenn die Bedingung gilt, darauf dass die Skript Version 4 für das Fevgames Google Sheet genutzt wird.
Mit “Erinnerung” kann eine einmalige Erinnerung an den Upload eingestellt werden.
Mit dem Button “Internen Bildcache löschen” werden alle gespeicherten Verknüpfungen zwischen den Nutzern und den eingesendeten Bildern gelöscht. Die Nutzer haben danach wieder den Status “kein Bild gesendet / Bestätigt”.
Es ist eine Sicherheitsabfrage zu bestätigen.
Auswahl Deiner Zeitzone
genaueres findest Du in der Userdokumentation
Wähle die von Dir gewünschte Bot-Sprache
genaueres findest Du in der Userdokumentation
Hier kann sich jeder Nutzer persönlich seine Werte der FS speichern lassen.
Die Funktion muss von jedem einzelnen Nutzer selber freigeschaltet werden.
genaueres findest Du in der Userdokumentation
Dieses Menü dient der Übertragung der Fevgames-Daten in den Bot, sowie Einstellungen zum Abgleich der User mit der Fevgames-Seite.
Mit dem ersten Button wird die Fevgames-ID festgelegt. Kontrolliere nach dem Eintragen den Link im Menü-Kopf.
Der Zweite Button Liest die FS-Daten aus der Fevgames-Seite und merkt sie sich in Deinem User-Datensatz. Die Daten stehen dann unter Import: im Menü-Kopf.
In der nächsten Zeile hast Du die Möglichkeit Differenzen des Uploadfensters zum FS-Fenster festzulegen. Drücke dazu die Buttons mehrmals, bis die gewünschte Differenz erscheint.
Passt alles, kannst Du mit “FS Daten in den Bot übernehmen” die Daten in die FS-Konfig des Bots schreiben. Unter dem nächsten Abschnitt “FS-Daten Config” hast Du die Möglichkeit selbige noch weiter anzupassen.
Ist “Prüfen nach Stats-Upload” aktiviert, so bekommt der Agent angezeigt, ob sein Name in der Liste auf Fevgames enthalten ist. Das ist gleichzeitig eine Prüfung der korrekten Schreibweise des Agentnamens.
In der nächsten Zeile wird die Zeit festgelegt, für die die Fevgames-Daten vorgehalten werden. Das soll die Frequenz der Anfragen an Fevgames verringern.
Bei Auswahl des Buttons bekommt man verschiedene Zeiten angeboten.
Handrefresh heißt, das kein automatischer Import von Fevgames erfolgt, die Daten müssen dann mit dem Kommando /refreshfev aktualisiert werden.
“Mindestanzahl Agents für Fevgames Abgleich legt fest, wieviele Agents die Fevgames Seite liefern muss, damit sie als korrekt gelesen gewertet wird.
2 Agents wären nur die beiden POCs, um sicherzustellen dass alle Agents importiert werden sollte ein Wert von 4 oder 10 gewählt werden.
Hier werden die eigentlichen Werte des FS eingestellt. Eine Vorkonfiguration kann wie im letzten Punkt beschrieben von Fevgames importiert werden.
Mit dem Button “Titel” kann der Titel des FS gesetzt werden. Leider ist kein Editieren möglich. Also am besten aus dem Kopf den Namen kopieren, in die Eingabezeile einfügen und dann ändern ;-)
Mit “Datum” wird der Tag des FS eingestellt. Auf dieses Datum beziehen sich dann alle anderen Termine der FS-Daten Config.
“Upl Start” und “Upl End” legen den Start- und Endzeitpunkt fest, zu dem Agents ihre Stats hochladen können. Es ist praktisch diese Zeitspanne etwas größer als die eigentliche FS-Dauer zu setzen, ein paar sind zu schnell, ein paar zu langsam ;-)
“Meet”, “Photo” und “Restock” sind die Termine beim normalen FS, aktuell (IFS@Home) verwenden “wir” nur “Meet” um das Zentrale Portal, das bei Fevgames gemeldet ist zu speichern.
Mit dem kleinen Marker 📍 kann die Position gesetzt werden. Du kannst einen Location-Link (Intel, Google oder Apple) in die Zeile eingeben oder eine Position mit der Telegram eigenen Funktion senden.
Mit dem Label 🏷 kann eine Beschreibung, z.B. Portalname festgelegt werden.
Und mit 🕗 die Zeit für den Termin.
Mit “Format Ausgabe für /fs” wird eine Vorlage für die Ausgabe des Befehls /fs erstellt.
Der Bot sendet Dir als erstes eine Aufzählung der möglichen Platzhalter, dann einen Standardvorschlag und dann die aktuelle Einstellung. Aus diesen kannst Du einen Text in die Eingabezeile kopieren und bearbeiten.
Nach dem Absenden prüft der Bot ob der Text von Telegram versendet werden kann. Scheitert das, sendet der Bot eine Fehlermeldung mit dem Fehlertext von Telegram:
⚠️ Der Text enthält Fehler, die die Ausgabe verhindern:
Bad Request: can't parse entities: Unsupported start tag "" at byte offset 0
Im folgenden können die Wertungen für den FS konfiguriert werden. Die Reihenfolge der Wertungen muss beachtet werden, dass sie richtig im Fevgames-Sheet eingetragen werden.
Klickt man auf eine vorhanden Wertung, bekommt man eine Liste der möglichen Wertungen und einen Button zum “🗑 Löschen” der Wertung. Einfach die gewünschte Wertung auswählen, oder den “🗑 Löschen” Button. Soll die eingestellte Wertung beibehalten werden, dann diese einfach wieder anwählen.
Für eine Zusätzliche Wertung den Button “➕ neue Wertung” anwählen und dann eine Wertung auswählen.
Hier werden die eingestellten Wertungen angezeigt, wenn eine Mindestanzahl eingestellt ist, steht der Wert hinter dem Wertungsnamen im Button.
Zum ändern einen Button wählen und in der erscheinenden Matrix die gewünschten Ziffern für die einzelnen Stellen wählen. Ausgewählte Ziffern werden mit _#_ hervorgehoben, im Untersten breiten Button steht der aktuelle Wert und kann übernommen werden.
Beim FS werden die Agents nach dem Upload und beim Befehl /info über den Stand des Erreichens der geforderten Wertung informiert.
Für das zweite Verify im Sheet ist es nötig alle Wertungen zu erfüllen, ggfls. auch das Selfi.
Wer Mindestwerte eingestellt hat MUSS in der folgenden Beschreibung Version “4 - Sheet Version 2.6 Manual (Bedingtes Verify) benutzen.
Im Kopf dieses Menüs findest Du den Namen des Sheets, sofern eins eingestellt ist, den Zeitpunkt, bis zu dem der Bot das Sheet bearbeiten darf, die Version und Name der Routine, die in das Sheet schreibt und der Nutzer dem das Sheet freigegeben werden muss, damit der Bot in selbiges schreiben kann.
Die ermittlung des Sheet-Namens geschieht “Live”.Das kann dazu führen, dass dieses Menü mit ein bischen Verzögerung angezeigt wird.
Mit dem Ersten Button “Link des ScoringSheets” kann Link zum Sheet dem Bot mitgeteilt werden. Dabei ist es egal, ob der Link aus der Adresszeile des Browsers oder über die “Freigeben”-Funktion von GoogleSheets ermittelt wird. Der Bot speichert intern nur die eigentliche ID.
Soll der Link zum Sheet gelöscht werden, gib ein “-” ein.
“Änderbar bis [datum]” legt fest, wie lange der Bot in das Sheet schreiben kann.
Der Bot schreibt immer die gesamten Daten als einen Block in das Sheet, daher gehen manuelle änderungen bei jedem Schreiben des Bot verlohren.
Nach diesem Zeitpunkt können Werte und Agents per Hand ins Sheet nachgetragen werden.
Besser ist es den Link des Sheets nach diesem Zeitpunkt aus dem Bot zu löschen.
Ist der Button “Import User von Fevgames ins ScoringSheet” aktiviert, werden auch User ins Sheet eingetragen, die noch keine Werte gesendet haben, aber auf Fevgames registriert sind. Das ermöglicht die Kontrolle von falsch geschriebenen Namen im Sheet.
Mit Auswahl der ScoringSheet Version kann die Routine zum schreiben ins Sheet ausgewählt werden, ggfls. auch die Version des Sheets.
Im Moment wird nur die eine Version des ManualSheets unterstütz, aber eine Routine, die das zweite Verify immer setzt und eine, die es nur setzt, wenn alle Bedingungen erfüllt sind.
Wer Mindestwerte eingestellt hat MUSS Version “4 - Sheet Version 2.6 Manual (Bedingtes Verify)” benutzen.
Die Nutzung des GoogleForms zum senden von Daten an den Bot ist nur eine Ausnahmelösung für Agents, die kein Telegram haben. Die Agenten bekommen keine Rückmeldungen vom Bot. Es gibt keine Möglichkeit zu kontrollieren wer die Daten sendet, die Zuordnung erfolgt ausschließlich anhand des Ingame-Namens.
Sollte der Ingame Name während des FS auch Daten via Bot senden, werden die Daten aus dem Form komplett ignoriert!
Teile den Link zum Formular nur mit diesen Agents.
Einrichtung:
Erstelle ein Formular mit zwei “Absatz”-Formularfeldern.
Gehe in die Einstellungen des Formulars und aktiviere “Maximal eine Antwort” und “Nach dem Senden bearbeiten”.
Verbinde das Form mit einem GoogleSheet, oder lass das Form ein GoogleSheet erstellen.
Im Kopf dieses Menüs siehst Du den Namen des Sheets, sofern ein Sheet verbunden ist, eine sehr kurze Funktionsbeschreibung und den User, für den Du das Sheet zum lesen freigeben musst, damit der Bot die Daten auslesen kann.
Mit dem Button “Link des Sheets” kannst Du dem Bot den Link des Sheets mitteilen.
Mit “FormularSheet einlesen” kannst Du die Daten des Formulars in den Bot lesen. Normal wird das ein Cron-Job regelmäßig erledigen.
Um einen Überblick über die erfassten Daten zu bekommen, kannst Du den Button “Erfasste Formular Daten anzeigen” benutzen. Achte auf die Zeitangaben, der Bot löscht keine Daten selber, es können also auch Daten von älteren FS auftauchen.
Um das zu vermeiden benutze vor dem FS “Erfasste Formular Daten löschen”. Das löscht die internen Formulardaten aus dem Bot. Nicht die Daten im Sheet. Somit werden beim nächsten Cron-Lauf oder mit “FormularSheet einlesen” die Daten wieder aus dem Sheet übernommen.
Die Selfi Verwaltung soll es vereinfachen, die Selfis der Agents zu sammeln.
Dazu können die Selfis an den Bot gesendet werden. Der Bot postet sie in eine dafür angelegte Gruppe und bietet Optionen zum Annehmen und Ablehnen der Selfis.
Abgelehnte Selfis werden aus der Gruppe und dem BotCache gelöscht. Je Agent kann ein Bild gesendet, ggfls ersetzt werden.
Der Bot speichert intern keine Bilder, nur die Unique ID für das Bild bei Telegram.
Wird für jeden FS eine neue Gruppe angelegt, können die Bilder nach dem FS direkt aus der Gruppe heruntergeladen werden.
Der Menükopf zeigt den Namen des Selfi-Chats an, intern gespeicherte Unique IDs.
Alt: haben einen Zeitstempel vor dem aktuellen UploadStart
Neu: haben einen Zeitstempel nach dem aktuellen UploadStart
gesendet: Vom Agent gesendet und nicht verifiziert oder verworfen
verifiziert: Verifizierte Bilder
Lege eine Gruppe für die Selfis an, füge den Bot hinzu und gib in der Gruppe /connect ein. Sollten mehrere Bots in der Gruppe sein, könnte die Ergänzung des Botnamens mit @ nötig sein.
Die gleiche Funktion kann auch mit “Gruppe verbinden” aus dem Menü ausgeführt werden, dazu muss die Gruppe vom Bot schon erkannt worden sein. Dann öffnet sich eine Liste aller dem Bot bekannten Gruppen. Wähle die gewünschte aus.
Der Button “Gruppe trennen und verlassen” löscht die Gruppe aus der Selfi-Funktion. Der Bot verlässt die Gruppe.
Mit “Uploads Start” und “Uploads End” kann der Beginn und das Ende des Uploads Fensters festgelegt werden.
Sollten die Zeiten mit den Stats-Uploads des FS übereinstimmen kannst Du auch den Button “Setze auf FS-Upload-Zeiten” verwenden.
Der Bot kann an den Selfi-Upload erinnern, wähle dazu die gewünschte Zeit vor Uploadende mit “Erinnerung:”.
Vor dem FS können mit “⚠️ Internen Bildcache löschen” alte Selfi-Daten gelöscht werden. Es ist aber auch kein Problem, sollten noch alte Daten vorhanden sein, der Bot filtert das anhand des Zeitstempels.
Für einen Real-FS kann der Bot die Nutzer jetzt auch per QR-Code verifizieren.
Mit “QR-Code auswerten”, kann man für sich persönlich die Auswertung Aktivieren, bzw Deaktivieren. Bei aktiver QR-Code Auswertung, kann man kein Selfi senden!
Der Befehl “/qrcode on|off” tut das gleiche.
“QR-Code-Token generieren” erzeugt ein neues Token zum Signieren der Daten im QR-Code. Wird ein neuer Token erzeugt, werden alle bis zu diesem Zeitpunkt generierten QR-Codes ungültig!
“ist Bedingung” macht die Verifizierung zur Bedingung für das zweite Verify im Sheet.
Dazu muss in der Scoring Sheet-Config die Version “4 - Sheet Version 2.6 Manual (Bedingtes Verify)” gewählt werden!
Die Nutzer generieren den Code über den Befehl /qrcode. Du kannst den Code als Bild direkt an den Bot senden (“QR-Code auswerten”) muss aktiv sein, oder Du sendest den dekodierten Text an den Bot.
Um ein paar Standardaufgaben abzunehmen, hat der Bot folgende in diesem Menü gebündelte Funktionen:
Agents, die über einen längeren Zeitraum (Standard 100 Tage) den Bot nicht benutzt haben, kann der Bot automatisch aus der internen Datenbank entfernen. Das hat keinen Einfluss auf den Status des Bots im Telegram des Nutzers.
Sollte ein Agent nach dem löschen einen Befehl an den Bot senden, bekommt er die Aufforderung “/start” einzugeben. Ausnahme, er sendet eine gültige Ingress Statistik an den Bot. In diesem Fall wird er sofort angemeldet, um fehlende Stats beim FS zu vermeiden.
Mit dem Button “Lösche User nach inaktivität von 100 Tagen” kann der Zeitraum eingestellt werden.
Der Bot kann die Agents an den Upload der Endstats erinnern.
Dazu kann mit “Erinnerung 10 Minuten vor Uploadende” der Zeitpunkt der (1.) Erinnerung vor dem Uploadende eingestellt werden.
Der Bot erinnert nicht nur bei fehlenden Endstats, sondern weist auch auf die Möglichkeit hin, die Stats zu aktualisieren, wenn der letzte Upload länger her ist als unter “Letzter Upload muss mindestens 10 Minuten alt sein” eingestellt.
Mit “Erinnerung nach 11 Minuten wiederholen”, kann auch eine wiederholte Erinnerung eingestellt werden. Dazu muss die Zeitspanne kleiner als unter “Erinnerung 10 Minuten vor Uploadende” sein.
Alle Wartungsoptionen werden standardmäßig per CRON-Job ausgeführt. Ausserdem kann man mit “Bei MOD-Anmeldung Wartung ausführen” den Bot so einstellen, dass die Wartung bei jedem Zugriff eines MODs ausgeführt wird.
Um Fehlermeldungen, die die Agents nicht sehen sollen nicht an alle MODs zu senden, kann man eine Telegram-Gruppe dafür einrichten.
Die dafür vorgesehenen Meldungen werden dann in die Gruppe gesendet, nicht an die MODs. Die Meldungen können nach Gruppen getrennt pausiert werden.
Zubeachten ist, das Telegram Bots nur das senden von 20 Nachrichten pro Minute in eine Gruppe erlauben. Alles was da drüber hinausgeht geht “verlohren”.
In diesem Menü kann die Ausgabe des Befehls /links festgelegt werden.
Die ersten beiden Optionen bieten die Möglichkeit einen Link für das Scoring-Sheet und die Fevgames-Seite zu de-/aktivieren.
Danach können eigene Links hinzugefügt oder bearbeitet werden. Einfach den Namen des Links auswählen oder ‘+’ für einen neuen Link.
Bei einem neuen Link wird der Name abgefragt, dann landet man im Menü für den Link.
Dort gibt es 3 Optionen für den Link
Der Bot kann in begrenztem Maß Gruppen gegen Bots und Spammer schützen. Dazu muss er zu den zu schützenden Gruppen hinzugefügt werden und Rechte zum Entfernen von Nutzern bekommen.
Danach kann der Chat unter dem Menüpunkt ausgewählt werden.
Der erste Menüpunkt “Einstellungen” zeigt die Chateinstellungen und ermöglicht das sich der Bot aus dem Chat selber entfernt.
Danach erscheinen mehrere Möglichkeiten gegen die geprüft werden kann. Diese sind mit grünen und roten Punkten markiert:
🔴 Trifft diese Prüfung zu, wird der Nutzer entfernt
🟢 Eine dieser Bedingungen muss zutreffen, das der Nutzer bleiben darf.
Wird eine Prüfung aktiviert, bekommt sie einen ✅
Geprüft werden kann gegen den Bot ( das der Nutzer im Bot ist ) oder andere Chats.
Die Prüfung gegen die ComBot-API ist aktuell noch auf eine Meldung im Bot-Log beschränkt, sie bannt noch keinen User.
Wird Meldung im Chat ausgeben aktiviert, dann wird bei jedem Nutzer eine Ausgabe zum Prüfstatus ausgegeben.
Speichert die Werte des FS in CSV-Dateien, die in Open-, Libre- oder Microsoft Office geöffnet werden können. Das funktioniert, so lange das “Uploadfenster” auf den aktuellen/letzten FS gesetzt ist.
Als erstes kommt eine Auswahl, aktuell “Sheet Version 2.6 Manual” und “Sheet Version 2.6 Auto”. Die “Version Sheet V2.6 Manual” ist für den von Fevgames vorgesehenen Weg mit dem Manual-Sheet:
https://docs.google.com/spreadsheets/d/10do1X0StD_MVZbLPGgwjq1dpXHDkbbR19IxFeQ5QrVU/copy
Nach der Auswahl der Version sendet Dir der Bot die CSV-Datei.
Fragt als erstes nach der Ausgabemethode für die Grafiken und erzeugt dann für jeden einzelnen Wert des FS ein Balkendiagramm.
Das funktioniert, so lange das “Uploadfenster” auf den aktuellen/letzten FS gesetzt ist.
Gibt die für die Meldung bei Fevgames relevanten Werte aus.
Das funktioniert, so lange das “Uploadfenster” auf den aktuellen/letzten FS gesetzt ist.
Zusätzlich erstellt er einen Link auf ein vorausgefülltes Meldesheet.
Ist analog zum Befehl /stat, nimmt für die Statistik aber nicht die Daten aus dem Bot, sondern aus dem Scoring-Sheet. Damit beachtet er auch nachträglich von Hand eingetragene Spieler.
Sendet den hinter dem Befehl übergebenen Text an alle Beteiligten des FS die zumindest Startwerte hochgeladen haben. Wird kein Text nach /sendmsg übergeben, so wird der Bot danach fragen.
Das funktioniert, so lange das “Uploadfenster” auf den aktuellen/letzten FS gesetzt ist.